@startuml

class Req_2205 <<Requirements>> {
Id = 2205
Text = "En tant qu'administrateur, je veux pouvoir afficher la liste des intervenants du fichier intervenants2014_2015.csv dans l'IHM"
}

class Req_2213 <<Requirements>> {
Id = 2213
Text = "En tant qu'administrateur, je veux pouvoir afficher la liste des sujets puis ajouter un nouveau sujet et sauvegarder la liste des projets dans un fichier .csv de mon choix"
}

class Req_2220 <<Requirements>> {
Id = 2220
Text = "En tant qu'administrateur, je veux pouvoir afficher la liste des étudiants indiquant le groupe, le sujet, le projet et l'ensemble des intervenants du projet dans l'IHM"
}

...
@enduml

package demo;

class Controller {}
class EmbeddedAgent {}
class PowerManager {}

/**
 * @extends Controller
 * @extends EmbeddedAgent
 * @navassoc - - 1..* PowerManager
 * @note this is a note
 */
class SetTopController implements URLStreamHandler {
  public String name;

  int authorizationLevel;
  void startUp() {}
  void shutDown() {}
  void connect() {}
}

/** @depend - friend - SetTopController */
class ChannelIterator {}

interface URLStreamHandler {
  void OpenConnection();
  void parseURL();
  void setURL();
  void toExternalForm();
}

/**
 * {product-name} will change your life!
 * @version {version}
 */

# CheckImage.rb
# 2014 -- JMB (initial code from JM Inglebert)
#----------------------------------------------------
re = Regexp.new("\.html$") # asciidoc result file (easier!)

dir = Dir.new('.')
dir.each  {|fn|
    if ( fn =~ re ) then
        print "asciidoc source : " + fn + "\n"
        paths = []
        # find all image: or image:: asciidoc macros
        File.open(fn) { |f|
          p 'opening ' << fn
            content = f.read
            paths = content.scan(/<img src="([^"]*)"/)
        }
        imagesDir='/Users/bruel/dev/Papyrus4Education/images'
        # test that path is a file
        paths.flatten.each {|path|
            print (File.file?(path) ? " OK " : " NOK ") + path + "\n"
        }
    end
}

#La documentation utilisateur devra fournir les informations suivantes :

file = ARGV[0]
membre = Regexp.new(ARGV[1])
groupe = Regexp.new(ARGV[2])
sprint = Regexp.new(ARGV[3])


f = File.open(file)
content = f.read

# liste des membres de l'équipe

res = content.scan(membre)
print "Membre : " + (res != [] ? " OK " : " NOK ") + "\n"

# numéro du groupe

res = content.scan(groupe)
print "Groupe : " + (res != [] ? " OK " : " NOK ") + "\n"

# Université Toulouse 2

res = content.scan(Regexp.new("Université Toulouse 2"))
print "UT2 : " + (res != [] ? " OK " : " NOK ") + "\n"

# IUT de Blagnac

res = content.scan(Regexp.new("IUT de Blagnac"))
print "IUT : " + (res != [] ? " OK " : " NOK ") + "\n"

# DUT INFO S3/Module MPA

res = content.scan(Regexp.new("DUT INFO S3/Module MPA"))
print "MPA : " + (res != [] ? " OK " : " NOK ") + "\n"

# le nom du projet : OPTI

res = content.scan(Regexp.new("OPTI"))
print "OPTI : " + (res != [] ? " OK " : " NOK ") + "\n"

# le SPRINT concerné

res = content.scan(Regexp.new(sprint))
print "SPRINT : " + (res != [] ? " OK " : " NOK ") + "\n"

#require 'minitest/spec'
require 'minitest/autorun'

#---------------------------------------------------
# Checking Titles
#---------------------------------------------------
    MAIN='main.wiki'
    File.open(MAIN) { |f|
          content = f.read
          titles = content.scan(/=+ (.*) =+/)
          # test that titles have Capital first letter
          titles.flatten.each {|title|
            describe File do
              it "Wiki should use sentence capitalization for all titles" do
                assert_match(/[A-Z].+$/, title)
              end
            end
          }
        }

#language: python
#python:
#- '2.7'
install:
- gem install asciidoctor
- gem install link-checker

script:
#- asciidoctor --version
#- ls -alF
#- whereis bash
- asciidoctor -a icons -a linkcss! -a numbered faq.txt -o output/faq.html
#- ls -al output
#- bash update-doc.sh
- rake check_links

# Following generated by
#
# travis login --pro
# travis encrypt -r jmbruel/PapyrusFAQ GH_TOKEN=<token generated on gitHub> --add env.global
env:
  global:
    secure: cEaBJq02ObnKSWQHP0c.....WMQX8Py4icaC8Cn9l62AqE4=

# if everything OK, then deploy on the web
after_success:
- bash update-doc.sh

#!/bin/bash
echo -e "Starting to update doc\n"

#copy data we're interested in to other place
cp -R output $HOME/output

#go to home and setup git
cd $HOME
git config --global user.email "jbruel#travis@gmail.com"
git config --global user.name "Jean-Michel Bruel"
git config --global push.default simple

#using token clone io pages branch
git clone --quiet https://${GH_TOKEN}@github.com/jmbruel/jmbruel.github.io.git  doc > /dev/null

#go into directory and copy data we're interested in to that directory
cd doc
cp $HOME/output/faq.html ./index.html
ls -al index.html

#add, commit and push files without provoking Continuous Integration
git add -f index.html
git commit -m "Travis build $TRAVIS_BUILD_NUMBER pushed to io pages -- [skip ci]"
git push -fq origin master > /dev/null

echo -e "Done magic with output\n"

# svn list http://.../MyRepo
branch/
tags/
trunk/

# svn cp -m 'Making test branch' http://.../MyRepo/trunk http://.../MyRepo/branch/newBranch
...

# svn list http://.../MyRepo/branch
newBranch/

[source,shell]

=== {revisions}

[icon="{iconsdir}/tuxteacher.png"]
[NOTE]
====
. Pour ceux qui ont le support avec eux (ordi, tablette, portable) : trouvez un exemple de violation de la bonne pratique <<DRY>> dans ce support de cours (indice : mes codes {ruby} sont souvent écrits à l'arrache)
. Pourquoi les concepteurs de {papyrus} insistent-ils sur la qualité de leur documentation?
====


:leveloffset: 0

:numbered!:

[[Glossaire]]
== Glossaire

*Acronymes UML/SysML*

`{act}`:: Raccourcis pour Diagramme d'**ACT**ivité dans une cartouche {SysML}
`{bdd}`:: Raccourcis pour **B**lock **D**efinition **D**iagram dans une cartouche {SysML}
`{dc}`:: **D**iagramme de **C**lasse {UML}
`{dss}`:: **D**iagramme de **S**équence **S**ystème (un {seq} où seul le système dans sa globalité est représenté footnote:[Il ne s'agit pas d'un acronyme {SysML} à proprement parler mais nous l'utilisons beaucoup.])
`{ibd}`:: Raccourcis pour **I**nternal **B**lock **D**iagram dans une cartouche {SysML}
`{par}`:: Raccourcis pour **P**arametric Diagram dans une cartouche {SysML}
`{pkg}`:: Raccourcis pour **P**a**K**a**G**e Diagram dans une cartouche {SysML}
`{req}`:: Raccourcis pour **REQ**uirements Diagram dans une cartouche {SysML}
`{seq}`:: Raccourcis pour **SEQ**quence Diagram dans une cartouche {SysML}
`{stm}`:: Raccourcis pour **ST**ate **M**achine dans une cartouche {SysML}
`{uc}`:: Raccourcis pour **U**se **C**ase Diagram dans une cartouche {SysML}

*Définitions générales*


[NOTE]
.Ressources
=====================================================================
Les définitions ci-dessous sont regroupées à titre indicatif. Je vous invite
à consulter les sources suivantes :

- Glossaire du http://www.sei.cmu.edu/architecture/start/glossary[Software Engineering Institute]
- http://www.computer-dictionary-online.org/[IEEE Computer Dictionary Online]
- http://fr.wikipedia.org/[Wikipedia] – Version française
=====================================================================

[[CI]]CI::
	_**C**ontinuous **I**ntegration_ : (Intégration Continue) est un ensemble de pratiques utilisées en génie logiciel consistant à vérifier à chaque modification de code source que le résultat des modifications ne produit pas de régression dans l'application développée (source link:
	http://fr.wikipedia.org/wiki/Int%C3%A9gration_continue[ici]).

[[DRY]]DRY::
	_**D**on't **R**epeat **Y**ourself_ : Un bon principe qui veut qu'on évite de répéter des tâches manuelles (comme les tests) en utilisant plutôt des scripts et des programmes.
OMG::
	_**O**bject **M**anagement **G**roup_ : L'organisme international chargé des principales normes liés à l'objet (CORBA, UML, etc.).
[[TDD]]TDD::
	_**T**est **D**riven **D**evelopment_ : Développements dirigés par les tests. On écrit les tests avant d'écrire le code. On travaille son
	code tant que les tests ne passent pas.
TRL::
	_**T**echnology **R**eadiness **L**evel_ : Système de mesure employé par des agences gouvernementales américaines et par de nombreuses compagnies (et agences) mondiales afin d'évaluer le niveau de maturité d'une technologie (cf. http://fr.wikipedia.org/wiki/Technology_Readiness_Level[Wikipedia]).
[[STI2D]]STI2D::
	**S**ciences et **T**echnologies de l'**I**ndustrie et du **D**éveloppement **D**urable : série du baccarauléat qui met
	l'accent sur les technologies transversales et qui a introduit en 2011 l'enseignement de {sysml}.
SysML::
	_**Sys**tem **M**odeling **L**anguage_ (TM) : Le langage de modélisation de systèmes maintenu par l'{omg}.
UML::
	_**U**nified **M**odeling **L**anguage_ (TM) : Le langage de modélisation généraliste maintenu par l'{omg}.

[[refs]]
== Liens utiles

- Le site officiel d'{UML} : http://www.uml.org/
- Un site très bien fait sur {UML} : http://www.uml-sysml.org/

[[refs]]
== Références

Voici quelques références utiles.

- [[[ENS2013]]] L. Gendre et J.-M. Virely, SysML. Tutoriel du 13/06/2013. ENS Cachan.
- [[[FIO2012]]] Fiorèse S., Meinadier J., Découvrir et comprendre l’ingénierie système, AFIS 2012.
- [[[FMS]]] A. Moore, R. Steiner, S. Friedenthal, A Practical Guide to SysML, The MK/OMG Press, MK/OMG Press, 2011 (2nd edition).
- [[[Fejoz2013]]] Loïc Fejoz. [[SysML4STI2D]]SysML4STI2D, présentation de SysML en STI2D, 2004. Disponible http://fr.slideshare.net/REALTIMEATWORK/sysml4sti2d[ici].
- [[[Fowler2004]]] Martin Fowler. UML 2.0 INFORMATIQUE PROFESSIONNELLE, 2004.
- [[[HAS2012]]] Haskins C., SE Handbook Working Group, INCOSE Systems Engineering Handbook: Version 3.2.2, International Council on Systems Engineering, 2012.
- [[[Harmony]]] Bruce Powel Douglass. Real-Time Agility: The Harmony/ESW Method for Real-Time and Embedded Systems Development. Addison-Wesley Professional, 2009. ISBN-10: 0-321-54549-4
- [[[KAP2007]]] Kapurch S., NASA Systems Engineering Handbook, 2007 (http://ntrs.nasa.gov/archive/nasa/casi.ntrs.nasa.gov/20080008301_2008008500.pdf[pdf]).
- [[[MeDICIS]]] ENSI Bourges/PRiSM.
- [[[Modelio2012]]] Systems Engineering using Modelio, INCOSE 2012 Tool Vendor Challenge Case Study. Disponible  http://www.modeliosoft.com/en/component/docman/doc_download/360-white-paper-systems-engineering-using-modelio-incose-2012-symposiums-tvc-case-study-en.html[ici].
- [[[OMG2009]]] The Current State of Model Based Systems Engineering: Results from the OMG SysML Request for Information. Mary Bone and Robert Cloutier, 2009. Disponible http://www.omgsysml.org/SysML_2009_RFI_Response_Summary-bone-cloutier.pdf[ici].
- [[[REQ2012]]] Guide Bonnes Pratiques en Ingénierie des Exigences, AFIS 2012.
- [[[Roques2010]]] {prfc}. SysML par l'exemple - Un langage de modélisation pour systèmes complexes. Eyrolles. À obtenir http://www.numilog.com/LIVRES/FICHES/62775.Livre[ici].
- [[[SeeBook2012]]] Embedded Systems Analysis and Modeling with SysML, UML and AADL, F. Kordon, J. Hugues, A. Canals, A. Dohet, Wiley, 2013.
- [[[Sommerville1997]]] Ian Sommerville, Pete Sawyer. Requirements Engineering: A Good Practice Guide. Wiley, 1997.
- [[[Styles]]] Scott W. Ambler. The Elements of UML 2.0 Style. Cambridge University Press, 2005. ISBN: 0-521-61678-6
- [[[SysML]]] OMG. Systems modeling language version 1.3. Technical report, 2012. Available http://www.omg.org/spec/SysML/1.3/PDF[here].
- [[[Walsh1999]]] Norman Walsh & Leonard Muellner. DocBook - The Definitive Guide. O'Reilly & Associates. 1999. ISBN 1-56592-580-7.
- [[[TAOUP]]] Eric Steven Raymond. 'The Art of Unix Programming'. Addison-Wesley. ISBN 0-13-142901-9.
- [[[TestsIndustriels2009]]] Guide méthodologique de l'industrialisation et référentiel de bonnes pratiques. Disponible link:http://lifc.univ-fcomte.fr/test_indus/index.php?option=com_docman&task=doc_download&gid=36[ici].

== A propos de ce document...

**********************************************************************
Document généré par mailto:{email}[{author}] via {asciidoctorlink} (version +0.1.5+) de 'Dan Allen', lui même basé sur {asciidoc}.
Pour l'instant ce document est libre d'utilisation et géré par la 'Licence Creative Commons'.
image:{iconsdir}/88x31.png["Licence Creative
Commons",style="border-width:0",link="http://creativecommons.org/licenses/by-sa/3.0/"]
http://creativecommons.org/licenses/by-sa/3.0/[licence Creative Commons Paternité - Partage à l&#39;Identique 3.0 non transposé].
**********************************************************************